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TURNING POINT 


This issue of Pro/file Updates closes out the newsletter's second year. I 
want to thank all of you for your generous and enthusiastic support. It was 
your suggestions, contributions, and even complaints that made the first two 
years of Updates a smashing success. And I think it is safe to say that the 
ZX Pro/File program is now much improved over its former self with all the 
enhancements the newsletter has offered. 


The many articles and improvements have, however, created a problem. I am 
running out of things to say (incredible, but true). After I put together 

the last issue with the machine code alphabetizing routine it suddenly 
dawned on me, that article would be a tough act to follow. What was I to do 
for an encore? Would there even be an encore? Would there be a future for 
Pro/File Updates? 


The thought of ending this newsletter saddened me because I enjoy putting it 
out. But I just couldn't see any big new improvements coming up, and without 
them there's not much point in having a newsletter. As I agonized over this 
dilemma, one reader--and I wish I could remember his name--offered the 
perfect solution. He said, why not broaden the scope of Updates to include 
all of the products I sell (Hmm, I thought, fresh topics to write about...) 
Keep it quarterly, increase the price to $16.95 per year (sounds better all 
the time...), and increase the number of pages to 16 per issue (...with only 
one minor draw-back). 


I mentioned this idea to several of you who called. Everybody seemed to 
think it was a good idea. Therefore, the Pro/file Updates as we know it 
shall end with this issue. In its place will be "COMPUTER UPDATES"; a 
broader name for a broader scope. COMPUTER UPDATES will continue as a 
quarterly publication. Subject matter will include improvements, extensions, 
ideas, tips, applications, program listings, and descriptions of the ZX/TS 
products I sell. I am not sure yet how many pages the new UPDATES will be, 
but it will definitely be larger that the present 8 page format. More pages, 
unfortunately, means more printing and postage costs, plus more time 
researching writing and typing. To cover this, the price for COMPUTER 
UPDATES must go up. But not a lot. The new subscription price shall be 
$12.95. This is just $3 more than last year. $3 is equal to 6 cups of 
coffee, | ticket to a lousy movie, or 1-1/2 boxes of Cheerios. 


Will you get your money's worth? Well, I'll let you decide. Inside this 

issue I'm including a sample of articles such as you would find in the new 
COMPUTER UPDATES. Read them. If you like them, subscribe. I think you'll be 
very pleased. 


HOW TO CONNECT YOUR TS/ZX TO A 
MONITOR--EASILY 


by Tom Laffin 


Anyone who has stared at those funny little 
moving marks or lines of distortion on TV 
displays, anyone who would like to enjoy a 
crystal clear image without the annoyance 
of RF interference and having to carefully 
adjust the TV set's fine tuning, or arrange 
cables just so, anyone who thinks a quality 
monitor would put the little devil into the 
professional class (and put an end to eye 
shock treatments), has GOT to try this. 


Purchase a quality nine inch video monitor. 
Make up a shielded cable using RG-174 or 
other high quality micromini coaxial cable. 
Open the case of your TS/ZX and observe 
three wires bent in a "U" shape coming out 
one side of the RF modulator (the tin can 
that your TV cable plugs into). The wire 
nearest the outside edge can be tapped 
into, with the center conductor of your 
shielded cable. Connect the braid of your 
cable to the circuit board ground. This is 

a place where the tin can has tabs coming 
through the printed circuit and is soldered 
underneath. 


Feed your cable out through the hole next 
to where you would plug in the TV cable and 
forget using that TV jack any more. (If you 
attempt to use the TV cable, you might find 
the display a little lighter, due to 
circuit loading caused by the capacitance 
of the direct video connection.) 


If your monitor has a switch for 75 ohm 
termination, or bridging, try it either way 
for the best picture. It doesn't matter to 
the TS/ZX if the direct connection is 
terminated or not. 


PRO/FILE PLUS CASSETTE CLARIFICATION 


Last issue I stated that cassettes of "ZX" 
which contained many enhancements published 
in Updates was available. Apparently it was 
not clear to many that the biggest 
enhancement of all, the machine code 
alphabetizing routine featured in the last 
issue, was included on this tape. Price is 
$16.95 + $1.50 postage. Send to me, Tom 
Woods, P.O. Box 64, Jefferson, NH 03583. 


PRO/FILE POKES FOR THE BYTE-BACK 
CENTRONICS PRINTER I/F 


by Gloria Gedonious 


Here is the Parallel I/F modification for 
the new Byte-Back interface. Load Pro/File 
and alter the printer code with: 


POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 
POKE 


16674,6 
16675,0 
16676,205 
16677,105 
16678,32 
16679,42 
16680, 14 
16681,64 
16682,195 
16683,138 
16684,32 
Change these basic lines: 

3010 POKE 16675,C2 
3020 RAND USR 16674 
3036 GOSUB 3500 


Add these lines: 


3500 CLS 

3510 PRINT 

3520 RAND USR (your print address) 
3521 RETURN 


BASIC BYTES FREE 
by David Youngquist 


When modifying ZX Pro/File it is nice to 
see how many BASIC bytes are free. The main 
menu can show this number with a= short 
machine code routine of 13 bytes. Space is 
needed in the 8-16K region or in the D$ 
(see Updates vol.l, #2, pg.5). Poke these 
numbers in succesive addresses: 


33,0,0,57,237,91,28,64,237,82,68,77,201 
Then change line 18 to: 


18 PRINT "XZ PRO/FILE BASIC 
BYTES ";USR (address of code); 
oo ENTER A SEARCH COMMAND!"--- 
-and so forth. 


Z80-B, BENT EPROMS, ROM-PAK NOTES 
from W. Komlosy 


\— lease note that the ROMPAK edition of ZX 
Pro/File has many program lines (all the 
DIM lines plus 9960/9970) which can be 
deleted after the program is transferred 
from eprom to memory and before the program 
is saved to tape. This saved memory can be 
used to enlarge DS or add modifications. 


By the way, that tip to replace the CPU 
with a Z80-B sure works fine here. I've got 


16 2716 EPROMS and 12 6116 SRAMS (on 4 


reworked "Hunter Boards), all plugged into 
the printer interface that is plugged into 

the rear of my computer without any 
buffering at all. Quite a load on the Z80-B 
when you consider that on the TS1000 PC 
board I have piggy-backed in the 2K RAM 
memory decoding and Oliger circuit for M.C. 
in high memory. That means 72K of memory 
and the improved 8K ROM all are loading 
down the CPU address lines constantly. 


I never did get the improved display 
options to work right even with the fix in 
Vol.2,#1. Errors in the Updates (which 
should be edited out before printing-Ha Ha) 

yould at least be corrected in next 
“issues. 


---Dear W. Komlosy, If I had that much 
stuff plugged into MY rear I would want 
some kind of buffering too. As regards to 
errors and the Display Option improvements, 
keep trying. You'll get it one of these 
days. Many have successfully made the mod. 
Typographical errors in computer programs 
are an editor's nightmare. I try my _ best 
and will continue to do so. After each 
issue goes to the printer, boy do I sweat 

it out until I hear from a reader that they 
got a modification working. A final note 


about the ROM PAK version of "ZX": ROMPAK 


is now officially out of business. This is 
probably a good thing because the service 
they gave would lead one to believe that 
they were out of business long before they 
really stopped taking people's money. The. 
good news is that Sunset Electronics is 
taking over the ROMPAK line. With a fine 
company like Sunset, you can be sure you'll 
get what you pay for and there'll be help 
~vhen you need it. Sunset is located at 2254 
\araval St., San Francisco, CA 94116. They 
have a monsterous catalog. Write for one. 


AUTOLOG, an extensive modification to ZX 
Pro/File is available from Communications 
Systems Center, Bridge St. Box 133, 
Hillsboro, NH 03244. AUTOLOG allows for 
automatic entry of single line files, 
printing as files are added, and resetting 

DS when memory is full. AUTOLOG is used as 
a police and fire department's radio and 
phone log, and at an alarm center to record 
periodic clocks. Write for info. 


INTRODUCING THE EXPERIMENTOR'S 
UNIVERSAL INPUT/OUTPUT PORT 


Some of you may remember that a LONG time 
ago, I said I wanted to offer a simple 
parallel port and use it as the basis of a 
series of programs designed to show 
computer hobbyists the what's, why's and 
wherefore's of "Programming for Ports". My 
plan was (and still is) to provide many 
interesting applications centering around 
this I/O port, and then through the 
documentation, explain how the program 
works so that you can glean information on 
programming techniques you can use in your 
own programs. After many months of design 
work, by both myself and John Oliger whom 
I contracted with to manufacture the port 
boards, as well as considerable time 
writing the first few applications, I am 
happy to say the product is ready to be 
launched. 


PORT FUNDAMENTALS 


If you are wondering what in the world a 
"port" is and why you would ever want one, 
let me introduce you to a few fundamentals. 
A "port" is a device which plugs into your 
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computer which makes it possible to 
exchange data with other devices. Your 
computer's mic and ear jacks are connected 
to a cassette port built right in to the 
computer. When you LOAD this port takes 
data from your tape recorder and puts it 
into the computer's memory. When you SAVE 
a program, you do the reverse. Data from 
memory goes out to the recorder. The 
picture generated by the computer goes out 
to the TV through a port. Data you type 
when you press on the keyboard goes into 
memory through a port. 


Ports are like nerves. Some connect sensory 
organs with the brain. Others serve as_ the 
conduit through which the brain sends 
impulses to muscles telling them to act. 


Through ports you can connect motors, 
temperature probes, electric eyes, 
vibration sensors, relays, sound 


instruments, chemical sniffers, lights, and 
other "real world" devices up to your 
computer. The data transmitted to the 
computer through the input ports can be 
analyzed and then signals can be sent out 
to turn on other devices as a response. 


Imagine a completely computer controlled 
solar heating system, a motorized robot, a 
fully automatic weather station, an alarm 
system, economical and accurate lab testing 
equipment. Or how about computerized 
guidance systems for telescopes, cameras, 
or video recorders. These are some of the 
things you can do with ports. 


Unfortunately, there is a giant gap between 
imagining these systems and actually 
implementing them. Programming for ports is 
a science unto itself. It is a fairly 
simple matter to get signals into or out of 
the computer, but interpreting those 
Signals and knowing if the interpretation 

is accurate is another matter entirely. The 
computer's eye view of the world presents 
quite a different reality from everyday 
affairs. When you program a computer to 
sense and act on outside events, you must 
look at the world through the eyes of the 
computer. To me, its rather like looking 
through a microscope or some other device 
which throws a completely different light 
on your perception of things. 


ABOUT THE EXPERIMENTOR'S I/O PORT 


The Experimentor's Universal Input/Output 
Port was designed to be useful in many 
different settings. It will plug into the 

back of the TS1000/1500, the TS2068, or the 


Spectrum without any modifications to 
either the port board or the computer. The 
board has 8 input lines and 8 latched 


output lines. This means that a_ binary 
series of highs and lows sent to the 

outputs will remain there until you change 
them by sending a different series of highs 
and lows. In addition there are two strobe 


lines provided. These output lines are 
active when the computer is inputting or 
outputting data to the port. They can be 


used for various forms of "handshaking". 


To make this port board easy for the 
experimentor to configure and reconfigure 
many times for different applications, 
connections to the inputs and outputs are 
provided by way of two 10 position female 
sockets. One socket is for the 8 input 
lines, a ground, and a strobe line. The 
other socket is the same for the output 
lines. These sockets allow for temporary 
solderless breadboard type hook-ups. You 
can also make your connections with the 


common 1/10th inch center male headers, or 
by using crimp-on male connector pins (a 


supply of these is included with the 
unit). 
Ports are like memory locations in that 


each port must have a unique address. This 
board is given the decimal address of 223 
(or DF in hex). It is quite easy to change 
this address in the unlikely event you have 
a peripheral which already uses this 
address. 


THE BASIC 1/0 TECHNIQUE 


The actual technique of reading values from 
or writing values to this port varies with 
both the program and the computer you use. 
With the Spectrum and TS2068 you can use 
the Basic IN and OUT commands: 


LET X=IN 223 


will read the 8 input lines and put the 
value it finds into the variable X. 


OUT 223,X 


rds the variable X out to port number 
‘<Z3. These commands are very similar to the 
PEEK and POKE commands except that instead 
of reading or writing to a memory location, 
you read or write to a port. 


On the TS1000/1500 there is no Basic 
command which will access ports. Instead, 
you must use machine code. (I should 
mention, however, that this will not be 
true for long. I expect to have a new 
program soon which extends the Sinclair 
Basic with 22 new commands. Among them are 
IN and OUT which work in the same way as 
those on the TS2068). Perhaps the simplest 
machine code routine you'll ever get from 
me is the one below which lets the TS1000 
access this port: 


LD A,00 
OUT (DF),A 
RET 

IN A,(DF) 
LD C,A 

LD B,00 
RET 


‘To enter this into your computer, create a 
REM line consisting of at least 11 spaces 
after the REM token. Then make the 
following pokes: 


POKE 16514,62 
POKE 16515,0 

POKE 16516,211 
POKE 16517,223 
POKE 16518,201 
POKE 16519,219 
POKE 16520,223 
POKE 16521,79 
POKE 16522,6 

POKE 16523,0 

POKE 16524,201 


Write to port 223 by poking 16515 with the 
value you wish to output. Then, RAND USR 
16514. If you connect the port up to the 
computer and execute the commands below: 


POKE 16515,255 
RAND USR 16514 


41 could use a voltmeter to measure the 
voltage at all 8 output connections and 
find that each one measures 5 volts. Then 


if you POKE 16515,1 and RAND USR 16514 the 
voltage at bit 0 would still be high, but 
all the others would be low. 


Reading data from the input port is 
accomplished by entering the command: LET 
X=USR 16519. When the machine code 
executes, it reads the instantaneous state 

of the 8 input bits and stores the decimal 
value in the variable X. If all the inputs 

are connected to ground, X will equal 0. If 
they are all tied to 5 volts, X will equal 

255. 


PORT PROJECT #1 
DATA COMMUNICATIONS BETWEEN 
TWO COMPUTERS 


This first project gives you the basis of a 
very useful application involving 1/0 
ports--communicating between two computers. 
Some benefits this ability gives are: 


*Sharing data between two separate 
computers 

*Moving data from the TS1000 into the 
TS2068 

*Increasing RAM capacity 

*Send data to be Iprinted or saved to 

a disk drive to the second computer 
thereby allowing the first computer to 
operate on something else. 

*Use two machine code programs which 
occupy the same area of memory by 
storing one in the first computer while 
the other program is being executed by 
the second computer. 


You end up with two independent computers 
able to run separate programs and able to 
share common data. In the case. of 
increasing ram capacity, the second 
computer can serve as a huge storage medium 
something like a RAM-DISK. Its almost like 
being able to plug a second 64K ram_ pack 
into your computer. 


This project connects the TS1000 with the 
TS2068. It is quite possible to hook two 

1000's or two 2068's together, but you must 
relocate the machine code to a different 
area of memory. Before you can start this 
project, you must already have a few items. 
First, you need two port boards (one for 

each computer). While this system uses the 


Ss 


Experimentor Port Boards mentioned here, 
there is nothing to prevent you from using 
other commercially available ports, or 
boards of your own design. All you need _ is 
8 bits of latched output and 8 bits of 
input. You also need a 64K ram pack for the 
TS1000 (one that gives you memory in the 
8-16K block). I used a Byte-Back UM64 
memory. Because the UM64 lets you switch 
this block in or out in 2K increments, you 
can put the machine code in the 8-10K area 
and still have the 10-12K block free for 
the Memotech printer interface. The 


Memotech 64K ram pack won't let you do 


this. If you don't use the Memotech I/F 
this is not a problem. 


To visualize how this system works, I use 
the "master/slave" concept. One computer 
(the 2068) serves as the master. The other 
(TS1000) is the slave. The job of the 
master computer is to keep track of what is 
stored in the slave's memory, and to issue 
commands to the slave. The job of the slave 
is to patiently sit and wait for commands 
from the master. Then, to perform the 
command specified. 


Listing 1. TS1000 Slave Basic Input Routine 


1 FAST 
5 LET N=a 
10 DIM ABC S18) 
20 FOR x=1 TO 209 
25 SCROLL 
30 PRINT X;"=2"3 
40 INPUT ¥ 
50 PRINT ¥ 
55 LET AStXI=CHRE Y 
57 LET N=N+yY 
40) NEXT xX 
70 LET AS¢255 TO 261)=CHRS 247 
+CHRE S2+CHRE 12°+CHRS S2+CHRE | 
SSt+CHRS SZ+CHRS 197 


80 FOR xX=2é67 TO Sik STEP 2 

sn LET A&¢CK TO K+1=CHRE 32+CH 
Re 70 

{o0 NEXT *« 

1iag CLS 


115 PRINT "SUM OF CODES INPUT I 
S:"aN:TAB G;"SHOULD BE: 23017" 


The machine code shown here provides a 
rudimentary set of routines which 
accomplish this. As listed, the master has 
three commands it can send: SEND memory to 
the slave, RECEIVE memory from the slave, 
and cause the slave to QUIT to Basic. More 
commands will be developed later as needs 
become apparent. Up to 128 different 
commands could be implemented. 


Two separate programs are required. One for 
the master computer, one for the slave. 
Type listing 1. into the computer you 
designate as the slave and RUN it. You will 
be asked to enter the values shown in 
listing 2. As you do this, the computer 
puts the value you input into an AS array. 
The remainder of the program moves this 
machine code down to address 8192, and lets 
you make a tape back up of the code in the 
REM line. You would load this tape any time 
you want to use the system. 


mentioned in this issue is available for 
$69.95 each or 2 for $109.95. Tom Woods, 
P.O. Box 64, Jefferson, NH 03583 


{17 TF N¢>23017 THEN PRINT "#* 

120 PRINT "CODE INPUT IS COMPLE 
TE. PRESS ENTER TO MAKE 
TAPE BACK-LIP" 

{22 INPUT xs 

126 SAVE "SLAVE" 

128 SLOW 

130 PRINT "NOW MOVING CQDE DCLIN 

TO 8192" 

140 LET 2=8192 

150 FOR X=1 TO 515 

160 POKE 2,CODE AgS¢x) 

170 LET 2=2+1 

180 NEXT x 

190 PRINT 

200 PRINT "TRANSFER IS COMPLETE 


210 PRINT “PRESS ENTEF TO START 
THE SLAVE SYSTEM" 

220 INPUT X¢ 

230 FAST 

240 LET X=USR 8262 


THE EXPERIMENTOR'S UNIVERSAL I/O BOARD 


Listing 2. TS1000 Slave Machine Code Poker Table 


1. ‘9? 22572 §3=192 $4=119 985=241 
ae 23=25 44=24 65=120 84=32 
oe Re 24-126 452251 <4=147 @87=247 
4=14 29=237 46=205 67=19 88=32 
B= 254 26=121 47=38 $8=32 S7=34 
S=19 27=123 48=32 69=239 90=254 
f=e20l 28=184 49=17 7O=201 Fil=S2 
f=22 Z29=32 30=0 f1=17 FZ2=229 
F=0 20=243 Si=0 72=0 932=205 
10-14 Si=Z237 S2=71 73=0 94=51 
11=223 B2=120 $3=237 74=205 9#5=32 
{e=71 S3=32 54=89 73=38 9S=58 
13=237 B34=252 S5=205 76=32 97=247 
t4=121 359175 Sé4=202 Yr=254 9g=32 
15=205 B86=211 57-32 78=4 Y9=33 
1é6=0 37=Z223 5g=42 79=40 100=06 
17=32 3B@=201 S¢=254 80=5 101=323 
18=237 29=14 40=32 S1=175 102=133 
19=8s 40=223 $61=25 82=237 103=111 
2o=42 941=237 $2=237 832=121 104=203 
21i=254 42=120 63=120 S4=24 1Q5=37 


104=94 
107=35 
108=86 
10%=235 
110=20% 
111=1¢% 
11i2=205 
1is=s4 
114=32 
115=233 
114=78 
117=107 
118=94 
119=35 
120=364 
121=237 
122=a83 
123=254 
124=32 
125=35 


1246=78 
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134=194 


125=40 


144=173 
145=35 
144=34 
147=254 


14s=22 
149=146 
150-242 


1S4=205 
{S5=45 
136=32 
157=24 
158=3e 
159=205 
160=115 
161=232 
162=175 
163=184 
144=40 
145=13 
16é6=42 
167=255 
168=197 


149=205 
170=7 
171=32 
172=35 
173=34 
174=254 
175=22 
174=193 
177=16 
178=243 
179=121 
190=254 
1S1=0 
192=40 
183=143 
184=61 
195=205 
186=7 

187=32 
18S=24 
189=137 
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206=205 
20 7=C 
208=32 
209=201 


After everything is entered and saved, you 
can hook the computers together. All you 
have to do is plug the port boards into 

heir respective computers (with the power 


“-urned OFF, of course) and make up a cable 


which connects each of the 8 input and 
output bits on one board to their opposite 
partners on the other. Inputs go to 
outputs, outputs go to inputs. Be sure that 
the data lines match properly. In other 
words, Output bit 0 should go to input bit 
0. Bit 1 goes to bit 1, 2 goes to 2, etc. 
It is easy to get them mixed up. Radio 
Shack now sells spools of 25 conductor 
ribbon cable which is ideal for making 
these cables (cat.# output bits of one 
computer to the 8 input bits of the other. 


When the connections are completed, load 
the slave tape into the slave computer. It 
will run automatically, placing the 


operating system down into low memory. Once 


the transfer is finished, FAST mode _ is 
selected and the computer goes into the. 
slave state. Because the computer is in 
FAST, there is no display when _ this 
happens. The keyboard is also dead. At 
first, this can be a little disconcerting 
because it appears as though the computer 
as crashed. If you entered the machine 
code correctly however, do not be alarmed. 
The slave is just patiently awaiting 


instructions from the master. The keyboard 
and TV display are no longer needed. In 

fact, you don't even need to hook up the TV 
if you don't want to. 


Now you're ready to load the 
computer. Once it 


master 
is in, your operating 


system is ready and waiting for you to use. 
You can integrate this system with other 
programs such as Pro/File 2068 or your own. 
The only thing you can't do is try to load 
machine code on top of the master operating 
system. In the case of Pro/File 2068, thére 
is no conflict. Other programs may be 


different. 
1 
5S CLEAR 647569 
2OQ FOR x=54772 To 
2a PRINT £5 °=";5 
40 INPUT “ADDRESS 
5@ FRINT ¥ 
68 POKE xX,y¥ 
72 LET N=N+¢¥ 
5A NEXT xX 
85 
23: LET N=N+PEEK xX: 
90 CLs : PRINT 
COMPLETE": PRINT 
OPES IS: ";N: PRINT 
325960 


CODE"; X$: SAVE 
@.268 


65020 


“; (x93 ” 


NEXT x 


REM MASTER INPUT PROGRAM 


LET N=@: FOR X=64772 To 65a 


“CODE INPUT Is 
“SUM OF INPUT ¢ 
“SHOULD BE:"; 


“PRESS ENTER TO SAVE 
“MASTER'CODE 6477 


Listing 3. TS2068 Master Basic Input Routine 


Listing 4. TS2068 Master Machine Code Poker Table 


B4778=197 6 205 
64771=6 5 7? 
64772=3 5 253 
B4775=1 & 175 
B4774=2 =e 134 
B4775s1 5 40 : 
64776=2 B4i 13 49 
S477? =e 54 62 49 
647782 64 255 649 
B4779 64 197 644 
= 64 205 644 
54 9 
64: 253 E 
64 35 
64: 34 
64 254 
64873=253 
64874=193 
64875=16 
B4876=243 
e4e77s121 
4878-254 
Pai 64879=0 
793 S48sa=200 
64754= 64851=61 
64795= 4882-24 
64 796= 54 149 
B47a7= 54 167 
B4798= 64 42 
B4795=: B43 a9 
64800= 4587-92 
64801= 6488a=1 
64802= 64939=13 
648a5= 648c0=a 
64804 = 64851=237 
64505= 64852=66 
64806 = 64853=126 
645a7= 648o4=254 64981=40 
64808= 64835=65  64352=14 
6450a= 64996=40 649835=197 
64e10= B4a97=2 64984 =205 
64811= 64893=207 64985=48 
64e12= 64999=1 64985 =253 
64813 = 64980535 64987-1935 


6d =126 
& =e54 
= =9 
fat =G2 
6 =243 
Pat =O5 
5 =126 
& =254 
6 =@ 
6 =32 
Ge =pd42 
6 =O5 
& =126 
6 =229 
Fie =33 
= 
=e54 
#=133 Bt bad 
S=11il AGE 
B@=203 AAS SLES 
L=37 650ae =293 
2-94 6S5ea03=8 
3=35 65a18=a 
4=086 BS5011=a 
S=235 65e@12=a 
=i S=289 BS5013=8 
B4é =o s7=19 B5014=8 
Be =i 8=233 BSea75=8 
B4542=08 9=205 6B5016=a 
44d 5=0 @=166 6S5a17=a8 
fFdd=8 1=253 BbSa1ls=8 
64545 =34 gered 6S819=0a 
BdS46=35 3=179 BSa2a=9 
6454 7=56 4=35 65aci=8 
64845 =237 SS=245 B5ea22=6 
B4549=E83 S8=253 BS5025=8 
B45580=254 B?7sod 65@24¢=-i152 
B45851=253 B3B=s+254 65025-2553 
BdS52=35 29-253 B50c6=202 
64853=75 44=119 6502 7=255 
B4854=35 41=35 65028=1565 
64d B55="Ta 42-1 65ea2e2og=se53 
64656-2081 43=4 


HOW TO USE THE MASTER COMMANDS 


With the MASTER/SLAVE software incorporated 


into your computer, you have _ these 

options: 

1. Save memory from the master into the 
slave. 

2. Load memory from the slave into the 
master. 

3. Cause the slave to quit to Basic. 

The general procedure for implementing 


these commands requires sending a command 
statement to the slave which tells the 
slave what it is to do. Several vital 
pieces of information must be passed to the 
slave in the command statement. First, the 
command itself, tells the slave whether it 

is to send bytes, receive bytes, or quit to 
Basic. Second, the slave start address, 
specifies where in the slave's memory 


saving or loading is to start. Third, the 
number of bytes to send or receive must be 
given. Finally, the master start address is 
passed. This address indicates where in the 
master computer's memory saving or loading 
is to occur. These parameters give the 
Slave all the information it needs: the 
command to execute, the starting slave 
address, the number of bytes to process, 
and the master start address. 


The above parameters are passed to the 
slave in the form of a string of characters 
which has the name AS. What you do is 
determine the parameters you want to pass. 
Then you place them in A$, and RAND USR 
64884 to execute the desired function. AS 
must have a length of 9 characters. The 
first seven are used to hold the parameters 
needed by the machine code. Each of these 
seven characters has a specific role. The 
first character is the CHRS number of the 


command you wish to send to the slave. For 
the three commands implemented, the codes 
are 0 for SAVE, 1 for LOAD, and 2 for QUIT. 
‘or example, to save memory, you would LET 
~AS(L)=CHRS 0. To load memory, you LET 
AS(1)=CHRS 1. 


The next two characters of AS represent the 
SLAVE start address where memory will be 
loaded or saved. These AS characters are 
written as a two byte integer, with the 
less significant byte first. The 

characters are written as CHRS numbers just 
like the command is. An easy way to put the 
proper character codes into AS$(2) and AS$(3) 
follows. Let's suppose you want the slave 
start address to be 64000 decimal. First, 
enter the command RAND 64000. This 
automatically converts the address into a 

2 byte integer whose values are stored in 
the system variable, SEED. By peeking SEED, 
you can get the right CHR$ for AS(2) and 
AS(3). After you RAND 64000, you would say, 
LET AS(2)=CHRS (PEEK 23670) and let 
AS(3)=CHRS$ (PEEK 23671). These commands can 
be entered in the immediate mode without 
line numbers, or you could add program 
lines to handle everything automatically. 


“the next pair of characters in A$, the 
fourth and fifth, represent the number of 
bytes you wish to save or load. Enter these 
characters in exactly the same way you do 

the previous two characters. If, for 
example, you want to transfer 1000 bytes of 
memory, you would RAND 1000, then LET 
AS(4)=CHRS (PEEK 23670), and LET AS(5)=CHRS 
(PEEK 23671). 


The sixth and seventh characters of A$ 
represent the address of the start in the 
master Computer where saving or loading is 

to occur. As before, RAND the address you 
want, LET AS(6)= CHR$ (PEEK 23670) and LET 
AS(7)=CHRS (PEEK 23671). 


Two more characters must be added to AS, 
bringing the total length to 9. But you 
only need to make them blank spaces. The 
master operating system places a second 
"number of bytes" parameter in these spaces 
for you. 


The actual job of sending data to the slave 
started with the command RAND USR 64884. 

“However, in order for parameters to be 

passed properly, AS must be the last 


variable in memory. There are many ways to 
arrange it thus. The simplest is probably 

to insert the line, LET AS=A$ just before 
you RAND USR 64884. As long as your final 
adjustment to A$ immediately precedes the 
RAND USR 64884 command, AS will be the last 
variable in memory. What you want to avoid 
is a situation where some other variable is 
acted upon before you RAND USR. This action 
would cause A$ to be located in the wrong 
place. 


SUMMARY OF PARAMETERS 


To recap the parameter passing procedure, 
I will summarize the above and then give a 
few concrete programming examples. First, 
parameters are passed in AS. AS(1) is the 
function you wish to perform. If AS(1)=CHRS 
0, you SAVE memory from the master to the 
slave. If AS(1)=CHRS 1, you LOAD memory 
from the slave to the master. AS(2 TO 3) is 
the start address of the slave. If you are 
saving to the slave, this is where the data 
will start. If you are loading to the 
master, this is the address of the first 
byte to go to the master computer. AS(4 TO 
5) is the number of bytes to process, or 
the number of bytes to save or load. AS(6 
TO 7) is the master start address. This is 
analogous to the slave address. If you are 
sending bytes to the slave, this address is 
the first byte to be sent. If you are 
receiving bytes from the slave, this is the 
address where the slave data will be sent. 
AS(8 TO 9) are blank spaces. Parameters 
must be passed in a string of the name AS, 
and it must be 9 characters long. Otherwise 
the computer will give you a REPORT 
2-error. 


In the case of the command which causes the 
slave computer to quit to Basic, the slave 
start address parameter is loaded into the 
BC register pair so that when the slave 
returns, this number can be used to trigger 
special functions. For example, you could 
pass the value of 1000 to the slave with the 
quit command. This would make the variable 
X equal to 1000 in the slave. You could add 
an additional line of basic to the slave which 
says something like: IF X=1000 then GOTO 
5000. Then at 5000, you could add more 
special programming. 


These save load and quit routines do not 
keep track of the data you transfer between 
computers. Often it will be very useful to 
be able to remember what is stored in a 
given location. It will be necessary to add 
some sort of directory or index routine in 
Basic to the master program to accomplish 
this. 


PROGRAM EXAMPLES 


1 LET BPS$="‘THIS I5 A TEST 
iG LET As=CHRSs 8 
SOQ ASHDONTZE BSSres 
BO LET AS=AS+CHR [PEER SSE TR: 
+CHRS iPEER S35711 
46 RANDOMIZE LEN os 
bs LET AGs=AS+CHRE ([FEER 23878: 
5 (PEER 22571: 
O LET OS fii =e iii 
S RANDOMTFE PEER SS5204+5554rpE 
. Sob ae 
SS LET AS=As+CHRS (PEER 235878: 
tC HRS (PEER 258741 
SQ LET As-fg$e4 a 
166 RAHDOMIFE USSR 64554 
TO HARE THE SLAYE QUIT To BASIS 


Ai 
S+CHR B+CHRE A 
+ 


aad 


TET) dd TTT 


Ase LUPO Pe ae 


snAe 


ee TH CH ay 


SSE. YOu NEED 


LINE 38 Ta: 


As you can see, transferring data from one 
computer to another requires more than just 

a USR call. The PEEKs and LETs in the above 
examples determine what, how much and which 
direction data is to travel. As is so often 

the case with computers, you can't just 

tell the computer to "do it" without first — 
telling the computer what it is you want it 

to do. Fortunately, Basic can be used to 
handle these housekeeping tasks, and there 
are many possible ways to reach the same 
end. Updates will have much more to say 
about this master/slave system. In the 
meantime, you have the central workhorse 
routines to experiment with. Have fun, and 


26 LET As=CHR H : : ie beige 
+CHRS G+ Q@+CHR$ B+CHRS B+" let me know what interesting tidbits you 
“ST OF REN SUIT : 
22 RANDOMIZE USR ease4 CIScOvers 
a 


SLAVE Disassembly 


ana CS MLAY “PUSH BC 
2001 Os20 LO B,20 
2003 1OFE DLUF OIN2Z OLUPF 
POOR Ci POP BC 
2o06 co RET ; 
2O0y 1400 SEND LO 0,00 
sun? OEDF LO C.OF 
2OOR 47 LD B.A 
BOQ EQ?*S QUT tf) .4 
SOQGE COO0rh CALL DLAY 
SO1L EGSs LUF1 IN E,¢cs 
2OLR 2GFE20 LO HL, «BADR? 
Sols if ACD HL.OE 


-Simple delay routine 

-Set initial count to 20 

-Then count down to zero 

-restore original BC value 

-then return. 

-Subroutine which sends bytes 

-Port # is DF hex 

~-B reg. stores # of bytes to send 

-This number is sent to master 

-Then wait for master to get set. 

-Master tells the slave which byte to send. 
~Point to start of data block to send aw 
~Add the offset supplied by the master 


10 - 


CDCAZ20 


110000 


LAST 


DONE 


SLWT 
AGIN 


RCV 1 


RCV2 
LUP. 


SLST 


ERRO 


A.OK 


COMD 


PRAM 


LD A,CHL} 
OUT ¢C),A 
LD A,E 

CP B 

JR NZ LUP1 
IN A,¢O) 
JR NZ LAST 
XOR A 

OUT <DF>.A 
RET 

LD C,DF 

IN A,¢O> 
RET NZ 

JR AGIN 
CALL SLWT 
LD DE,0000 
LD B.A 

OUT ¢(C>,E 
CALL DLAZ2 
LD HL,¢ BADR) 
ADD HL,DE 
IN A,¢C) 
LD ¢HL),A 
LD A,B 

SUB E 

INC DE 

JR NZ LUP. 
RET 

LD DE,O000 
CALL SLWT 
CP 04 

JR Z2 A.OK 
XOR A 

OUT ¢C),A 
JR SLST 

LD HL,BUFF 
LD ¢< BADR)? ,HL 
PUSH HL 
CALL RCV2 
LO A,¢BUFF> 
LD HL,TABL 
ADD A,L 

LD L.A 

SLA L 

LD E,¢HL? 
INC HL 

LD D,¢HL>? 
EX DE,HL 
POP DE 

INC DE 
CALL DONE 
JP CHL) 

LD H,D 

LOD L,E 

LD E,¢HL? 
INC HL 

LD O,¢HL> 


-HL now points to address of char. to send. 

~out it goes. 

-Is the byte sent the last one? 

-Find out by comparing with B register. 

~If not, go back to LUP1 to send another byte. 

-Otherwise, wait til master is finished processing. 

-This is done by just sitting until a zero comes in from master. 
-Then send a zero out to the mester, and return. 


-Slave Wait routine waits for a byte to come from the master. 
-It just reads the port 

-and returns if the byte read is not zero. 

Otherwise, it reads the port again. 

-Subroutine to receive bytes from master. First, call the wait 
routine. Then set DE counter to zero. 

~The first byte input tells how meny bytes to expect. Put it in B. 
-€ register tells the master which byte to send. Output the value 
-then delay to allow time for the master to catch up. 

-Put first address where received data is to be loaded into HL 
~Add the offset to it. 

-Read the byte from the master. 

~and put it into address specified by HM. 

-Have we received the last byte? Find out by subtracting 

-the value in E from A 

-increment the counter 

-If A-E <>0 then go back to receive another byte. 

Otherwise, we're done, so return. 

Slave Start. This is the main entry point (USR 8262). 

-wait for a signal from master. 

-Is it a &? 

-If yes, it means a command is coming so proceed to read it. 
~If no, its garbage so send a zero out to the master 


-and go back to Slave Start. 

-First, load HL with address of command buffer (20F7 hex). 
-Then put it in BADR variable. 

-Save the register HL 

and go to receive bytes, putting them in the buffer. 
-The first byte of the buffer is the command. 

-HL is loaded with the address of the command table. 
-Then the command offset is added 


-so that HL points to the command handler location in the table. 
~The address in the table is loaded into DE 


-Then its put back into HL 

~The second byte in the buffer is popped off the stack 

-and stored in DE 

-Send a zero out to the master. 

-and jump to the routine specified by the commend. 

-Subroutine to interpret parameters sent by master. 

~2nd and 3rd bytes in buffer store the slave address parameter. 
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REM2 


BS} 


FMDF 


Lo 
IWC 
Lo 
Thc 
LO 
RET 
CALL PRAM 
OF A 

TF OB 

JF 2 FEMS 
PUSH 8 
CALL RCW 
CALL COME 
POP &C 
TMi HL 

LO ¢ BADR: 
OQUN2Z NEBL 
DEC C 

JF 2 SLST 
CALL FCW 
JF FINT 
CALL FPRAM 
SOR & 

Cr 6 

JF 2 FMODR 
LO A.FF 
PLUSH BC 
CALL SENG 
INC HL 

LO «BADR» 
POF BC 
OUINZ NKXES 
LO A,L 

Cr ad 
JR 2 
DEC A 
CALL SEMD 
JF SLST 


YB CR 
HL 
m.tHL3 
HL 
B.oHL 


SLOT 


CE 


HL 


HL 


-Put this address in BADR variable. 
-4th and 5th bytes are the Number of bytes to send/receive parameter. 


-Return with this number in BC. 

-Command handler to load a block of bytes from the master. 
-First, get parameters, and determine how many bytes to load. 
-If B=0, there are less than 255 

-so load them at REM2 

-otherwise, load B blocks of 255 bytes each. 

-One block of 255 is loaded 

-When complete, send a zero out to master. 

-Get the count, 

-Advance HL to point to the next address to load 

-store it in BADR 

-Then loop back to load another block. This repeats til B=0. 
-Then the remainder is loaded. C tells how many bytes to load. 
-If its zero, youre done so go back to SLST 

-Otherwise, receive the bytes. 

-When complete, go to FINI. 

-This is the command handler to SEND bytes to the master. 
-First get the parameters from the buffer just as in loading. 


-If less than 255 Bytes need sending, do it at RMDR. 
-Otherwise send B blocks of 255 bytes each. 
-Save the count. 

-Send the block. 

-Advance HL to point to next byte to send, 

-and put it in BADR. 

~Restore the count. 

“And repeat til B=0 

-Then send the remainder. A=# of bytes to send. 
~-If its zero, youre done. 

-So go back to SLST. 

-Otherwise, send A number of bytes. 


-Then go back to SLST 
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UNCLASSIFIED 


Sell that piece of gadgetry that failed the 
smoke test, or that extra printer, or mem- 


ory pack. Non-commercial ads: $5.00 for 
5 lines. 


FOR SALE: Memotech Centronics 


or 516 365-8737. 


Interface 
w/cable..$70. Memotech HRG interface $60. 
Both in original boxes. Call 212 535-1651 


COMPU/BUG Spray!! Computer error has 
forced the liquidation of 2000 cases of this 
amazing, safe, easy to use bug eliminator. 
Guaranteed organic, no harmful residues. 
FREE can for the first 500 callers. Dial: 


1-800-B-U-G-O-F-F-Q Todayll! 


FOR SALE: Aerco Disk System for TS/ZX 
complete w/2 drives, cables & DOS. $300 or 
trade for modem or serial LQ Printer of 
equal value. Jim Comperchio, Box 1347, 
Wolfeboro, NH 03894. (603) 569-4545, 


FOR SALE: C. ITOH model M7500 dot matrix 
printer. Brand new. Same speed and functions 
as the Prowriter but costs only $250+$7 shipping. 
A good light to medium duty printer. Tom Woods 


P.O. Box 64, Jefferson, NH 03583 


REMEMBER to RENEW your subscription to 
Updates! This is your last issue for the current 
year. Send $12.95 to Tom Woods, P.O. Box 64, 
Jefferson, NH 03583 


eG 


Se ya 


ZOBD EB QUIT EX DE,HL Command handler to quit to basic. 
ZOBE 4E LD C,¢HL> -The master address is loaded into HL 
ZOBF 23 INC HL ~Then into BC 

“ICG 44 LD B.¢HL3 


J JOL 832220 JP DONE -so that the Slave USR will return the value in 8C 

2004 Cbh2220 FINI CALL DONE -After loading the last block of data, you come here where 
Zac? C34620 JP SLST a zero is sent to the master. Then you go back to SLST. 
2OCA Cpoaoz0 DLAZ CALL DLAY -A second delay routine called from the Receive Bytes routine. 
SOCD CoaGzh TALL DLA -Calls the delay routine twice for a longer pause. 


2000 Cy? RET 


MASTER Disassembly 
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EBSU1 CALL PRAH - 
“OR A 
Cr B 7 
JR Z,REHL 

HXBS LO ALF 
PUSH BC 
CALL SEND 
THOOHE -Advance HL to next address 
LO (BADR .H: -and store it in BADR 
POP 6c ; 
CUZ, HXBS “Loop back tii ail blacks sent. 
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THO HL 

LO A, tHL: 

cP aa 

JR NZ. ERRS 

TNC HL 

LO A, CHL: 

cP ae 

JR NE. ERRS 

THC HL 

LD A, fHL: 

PUSH HL 
COMD LO HL. TRB. 
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